home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / cal14s5.arc / CALLS.DOC < prev    next >
Text File  |  1988-11-09  |  11KB  |  277 lines
  1.  
  2.                              CALLS.EXE
  3.  
  4.               Call analyzer for PCBoard versions 11.7 
  5.   (updated for PCBoard 11.8 and PCB/ProDOOR, S.H.Smith, 07/05/87)
  6.           (updated for PCBoard 12.1, S.H.Smith, 01/16/88)
  7.  
  8.  
  9.      Note:  Warren Lauzon is no longer supporting this program 
  10.                (since he's completely rewriting it)
  11.         So, please don't bother him with support questions.
  12.  
  13.               If you need help with it, contact me at
  14.                          Samuel H. Smith,
  15.                        Sysop, The Tool Shop
  16.                           (602) 279-2673
  17.  
  18.  
  19.  
  20.                  CHANGE HISTORY (in reverse order)
  21.                  =================================
  22.  
  23. Updated for changes in ProDoor betas dated after 10-14-88.
  24.  
  25. Version 14s5 14-Oct-88 S.H.Smith
  26. -----------------------------------------------------------------------
  27.  
  28. Removed ARC-specific terminology.  Updated for similar changes in
  29. ProDoor betas dated after 10-9-88.
  30.  
  31. Version 14s4 10-Oct-88 S.H.Smith
  32. -----------------------------------------------------------------------
  33.  
  34. Added a report of "Free Downloads" for compatibility with 9/30
  35. prodoor betas.
  36. Added a "Peak Hours" command line parameter.
  37. Deleted "Time Distribution" report because it was so slow and inaccurate.
  38.  
  39. Usage:
  40.    calls callers-file output-file report-list min-downloads peak-hours
  41.  
  42. callers-file is your pcboard CALLER file
  43. output-file  defaults to CALLFILE.DOC
  44. report-list  defaults to ANBCDEFGHIJKLM
  45. min-download defaults to 2
  46.  
  47. peak-hours   defaults to YNNNNNNNNNNNNNNNNYYYYYYY
  48.                         {0         1         2   }
  49.                         {012345678901234567890123}
  50. Examples:
  51.   calls \pcb\main\caller \gen\blt3
  52.   calls \pcb\main\caller \gen\blt3 ABCEFG 4 NNNNNNNNYYYYYYYYYNNNNNNN
  53.  
  54. The legal report-list letters are:
  55.    A: system statistics            B: graphic modes
  56.    C: baud rates                   D: hourly usage
  57.    E: conferences joined           F: bulletins read
  58.    G: doors opened                 H: download protocols
  59.    I: download efficiency          J: upload protocols
  60.    K: upload efficiency            L: batch sizes
  61.    M: files downloaded             N: security statistics
  62.                                    Z: insert a blank line
  63.  
  64. Version 14s3 10-03-88 S.H.Smith
  65. -----------------------------------------------------------------------
  66.  
  67. Updated for new conference joined and bulletin read log formats.
  68. Added a check for empty caller log files.
  69.  
  70. Version 14s2 24-Sep-88 S.H.Smith
  71. -----------------------------------------------------------------------
  72.  
  73. Updated protocol letters for PCBoard 14 compatibility.
  74.  
  75. Version 14s1 20-Sep-88 S.H.Smith
  76. -----------------------------------------------------------------------
  77.  
  78. Updated new user registration for new PCB 14 message format.
  79.  
  80. Version 12s21 22-Jul-88 S.H.Smith
  81. -----------------------------------------------------------------------
  82.  
  83. Added support for node chat.
  84.  
  85. Version 12s20 22-Jun-88 S.H.Smith
  86. -----------------------------------------------------------------------
  87.  
  88. Added a new data file CALLS.DIR, and a new graph of Time Usage by Activity.
  89. Create the file CALLS.DIR in the current directory.  List all your download
  90. and upload directories in this file (one directory per line).   CALLS will
  91. use this to search for each file that has been downloaded or uploaded.  The
  92. files must be located to determine file size, which is used to calculate the
  93. minutes spent downloading and uploading.  File sizes are determined only the
  94. first time a file is seen.
  95.  
  96. Version 12s19 12-Jun-88 S.H.Smith
  97. -----------------------------------------------------------------------
  98.  
  99. Changed ARCM message counter to a long integer to prevent overflows.
  100.  
  101. Version 12s17 10-May-88 S.H.Smith
  102. -----------------------------------------------------------------------
  103.  
  104. Added support for ProDoor's new ARC Mail feature.
  105.  
  106. Version 12s16 16-Apr-88 S.H.Smith
  107. -----------------------------------------------------------------------
  108.  
  109. Added checks for 24:xx instead of 00:xx in some caller log entries.
  110. Should prevent some runtime errors.
  111.  
  112. Version 12s15 12-Mar-88 S.H.Smith
  113. -----------------------------------------------------------------------
  114.  
  115. Recompiled with stack and range check enabled - slower, but safer.
  116.  
  117. Version 12s14 11-Feb-88 S.H.Smith
  118. -----------------------------------------------------------------------
  119.  
  120. Improved bulletin activity report formatting.
  121. Made changes to allow caller logs with over 32000 entries.  Changed graphics
  122. to allow > 100% (for MNP modems in efficiency reporting).
  123.  
  124. Version 12s13 11-Feb-88 S.H.Smith
  125. -----------------------------------------------------------------------
  126.  
  127. Made the 'remote dos time' statistic work properly (broken ever since
  128. PCB 12.)   Added entries in protocol table for all letters of
  129. the aplhabet.
  130.  
  131. Version 12s12 19-Jan-88 S.H.Smith
  132. -----------------------------------------------------------------------
  133.  
  134.  
  135. Added the ability to store an internal summary of your caller log. 
  136. This makes it possible to add small daily caller logs and produce 
  137. the full report without keeping the whole caller log on file.  It 
  138. also reduces time spent scanning the log file. 
  139.  
  140. Each time CALLS is run, it looks for CALLS.SAV in the default 
  141. directory.  If it is present, it loads this "saved summary" into 
  142. memory and adds the specified caller file to it.  After the report 
  143. is generated, CALLS.SAV is updated to include the new data.   Here 
  144. is a recommended EVENT.SYS sequence: 
  145.  
  146.      1. cd \pcb
  147.      2. calls main\daycal gen\blt3 zzAzNBCDEFGHIJKLM 2
  148.      3. type main\daycal >>main\caller
  149.      4. del main\daycal
  150.  
  151. Use PCBSETUP to change the caller log filename from the usual 
  152. 'caller' to 'daycal' - this will be your "daily caller log".   
  153.  
  154. Line 2 runs the caller log report on the daily log and generates 
  155. BLT3.  Line 3 adds the daily caller log to the end of the 
  156. "historical" caller log.  Line 4 deletes the daily log (pcboard 
  157. will make a new one for you).   
  158.  
  159. If you are short on disk space, you don't even need to keep the 
  160. 'main\caller' - just delete it.  The information in CALLS.SAV will 
  161. be enough to generate the full caller log report. 
  162.  
  163. If for some reason you want to start over with a fresh log, just 
  164. delete 'calls.sav' and calls.exe will create a new one for you.   
  165.  
  166. If you don't want to take advantage of this 'daily caller log' 
  167. feature, just add the line 
  168.    del calls.sav
  169. before the 'calls \pcb\main ...' line in your event.sys - without 
  170. the .sav file, it will act just like it used to. 
  171.  
  172. Note: if you run CALLS twice on the same caller log, the 
  173. information will be added to CALLS.SAV twice!  So, either make a 
  174. backup copy of CALLS.SAV, or always delete daycal when you run 
  175. calls. 
  176.  
  177. Version 12s11 16-Jan-88 S.H.Smith
  178. -----------------------------------------------------------------------
  179.  
  180. Moved security related statistics to a new report (code 'N'). Added 
  181. a fourth parameter to specify the minimum number of downloads 
  182. needed to include a file in the files-downloaded report. 
  183.  
  184. Version 12s10 31-Dec-87 S.H.Smith
  185. -----------------------------------------------------------------------
  186.  
  187. Sorted entries in system statistics report.  Added reporting of 
  188. Archive test runs, archive extract runs and re-arc runs. 
  189.  
  190. Version 12s9 27-Dec-87 S.H.Smith
  191. -----------------------------------------------------------------------
  192.  
  193. Added a third command-line parameter to specify the reports to 
  194. generate. This lists the specific report sections to produce and 
  195. the order in which they will appear.   
  196.  
  197. If, for example, you wanted to produce only the hourly usage (D), 
  198. bulletins read (F), and system statistics (A) reports (in that 
  199. order), the command line would be: 
  200.    calls \pcb\main\caller \pcb\gen\blt3 DFA
  201.  
  202. -----------------------------------------------------------------------
  203.  
  204. Version 12s7 21-Dec-87
  205. Version 12s6 29-Nov-87
  206. Version 12s5 20-Nov-87
  207. Version 12s4 07-Nov-87
  208. Version 12s3 12-Oct-87
  209. Version 12s1 10-Oct-87
  210.  
  211.  
  212.  
  213.                       ORIGINAL DOCUMENTATION
  214.                       ======================
  215.  
  216.  
  217. Phoenix Arizona                                  Feb 23, 1987
  218.  
  219.      This documentation covers version 11.8 of CALLS118.COM, a 
  220. call analyzer for PCBoard 11.8. 
  221.      It was written in Turbo Pascal, and is in it's 7th update 
  222. with this version.  Previous versions had various names and 
  223. version numbers such as "pcbcalls", "calls5b" etc.  From now on, 
  224. it will carry the same version number as PCBoard.  If any 
  225. revisions are made or required, it will have a letter suffix. (ie 
  226. 117b). 
  227.      This version contains only minor mods to include changes made 
  228. in going from 11.6 to 11.7.  The Imodem and Gmodem protocols have 
  229. been added, some minor cleanup was done on the displays, and the 
  230. error file, BLT99.DOC has been eliminated as redundant and of not 
  231. much value. 
  232.  
  233. OPERATION
  234.  
  235.      This version works pretty much the same as all previous 
  236. versions with the exception that the error file "BLT99.DOC" has 
  237. been eliminated. 
  238.      The program is very easy to run, requiring only access to the 
  239. callers file.  This can be done in one of two ways: If you run it 
  240. from your 'MAIN' dir, you can just type CALLS118 and it will 
  241. default to an input file name of "CALLERS" and an called 
  242. "CALLFILE.DOC". 
  243.      It will also support command line parameters, so you can use 
  244. it in a batch file or in your "EVENT.SYS" file, as I do. The .COM 
  245. file should be in your \PCB dir, though this is not required.  
  246. Below is a sample of part of my .SYS file: 
  247.  
  248.   calls117 d:\pcb\main\callers e:\pcb\gen\blt10
  249.  
  250. Both parameters should be specified: the first one tells it where 
  251. to find the file (d:\pcb\main\callers) and the name of the callers 
  252. file.  The second tells it where to put the output file, in this 
  253. case I am sending it to Drive D with the name "BLT10". 
  254.  
  255. There are a couple of things that make for better operation: 
  256.   1.  Do not mix callers logs of pcboard 10.0 and 11.7.  I have
  257. heard of no problems mixing 11.6, 11.7 and 11.8.
  258.   2.  For proper operation, your clock and date MUST be correct; if 
  259. the programs finds that your log begins in 1987 and ends in 1980, 
  260. it will usually abort.  If not, the numbers will be totally wrong 
  261. in most cases. 
  262.   It is recommended, though not required, that you start a new 
  263. callers log if you are new to this program.  It is most accurate 
  264. when the log begins with "New callers log initiated "etc. 
  265.  
  266.      Please give it a try and let me know what you think of it, as 
  267. the only way I can put in needed changes is with feedback from the 
  268. users.  You can leave any comments at my board (Phoenix Techline) 
  269. at 602 936-3058 (1200-9600), 24 hours. 
  270.  
  271.      I have included the source code in this version so that it may 
  272. be customized if you desire.  If you make any major changes or 
  273. improvements, please upload them to my board at 602 936 3058. 
  274.  
  275.                           Warren Lauzon
  276.     
  277.